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/*============================================================:^========= 

PageHistory methods 
Description: 

5 definition of the PageHistory methods 

====================================================^================= */ 

function PageHistory_setPageFlag{name, flag) { 

//variable used in the cookie: literal string with ' to escape the potential : inside of name 
10 var namelit = + name + 

//set it in the cookie string 

//case in it is in pages already, then modify value in cookie 
if (!this.isNotlnHistory(name)) { 

var repi = new RegExp(namelit + ":" + "['^\\s]*\\s"); 
15 debug(GenDebug, "this.cookie before", this.cookie); 

debug{GenDebug. "repI", repI); 

this.cookie = this.cookie.replace(repl, namelit + ":" + flag + " "); 
debug(GenDebug. "this.cookie after", this.cookie); 

} 

20 else { 

//case cookie empty, create it 
if (this.cookie ""){ 
Ca this.cookie = "{ " + namelit + ":" + flag + " }"; 

y3 } 

-.^5 //else add it to the beginning 

f^j else { 

£1 this.cookie = "{ " + namelit + ":" + flag + " , " + this.cookie.substr(1 ); 

\i } 

this.size++; 

^0 debug(GenDebug, "this.size", this.size); 

^- ^ //case size > maxsize, remove Iru = end 

- if (this.size > this. maxsize) { 

H debug(GenDebug, "this.cookie before size restraint", this.cookie); 

rU this.cookie = this.cookie.slice(0, this.cookie.lastlndexOf(",")) + "}"; 

r35 debug(GenDebug, "this.cookie after size restraint", this.cookie); 

m ) 

a } 

Q debug(GenDebug, "this.cookie end", this.cookie); 

//set it in the hashtable 
40 this.pages[name] = flag; 

//set the cookie 

setCookie("pageh", this.cookie); 

} 

45 function PageHistory_getPageFlag(name) { 

if {lsDef(this.pages[name])) return this.pages[name]; 

} 

function PageHistoryJsNotlnHistory(name) { 

if (lsUndef(this.pages[name])) return true; 
50 return false; 

} 



/*================ 

PageHistoryO 
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definition of the PageHistory constructor , 

The PageHistory object stores a mru/lru (most and least recently used) list of size 
maxSize pages for which you submitted a form 

When you add a page and the list is full we discard Iru and add it as mru 
5 Pages are characterized by a guid and a a flag 

The flag indicates if the page has already been submitted 
This object has some methods that lets you add a page, update a flag for a page 
and get a flag from a page. 

//no need to use prototypes since we use only one instance of the object 
function PageHistory(maxsize) { 

//define the member variables 

this.maxsize = maxsize; 
15 this.size = 0; 

//we store a js expression defining an associative array in the cookie 

//we instantiate the array for quick lookups in the js object pages 

//we keep the cookie to manage the Iru/mru for serialization 

//this makes the whole thing much faster: remove beginning and add to the end are very easy ops 
20 on strings 

//and we don't have to loop to serialize/deserialize 

this.cookie = getCookiefpageh"); 
£j debug(GenDebug, "this.cookie", this.cookie); 

y3 if (this.cookie ==""){ 

'^25 this.pages = new Object(); 

hi } 
u else { 

this.pages = eval("bozo = " + this.cookie); 
this.size = this.cookie.splitC,'),length; 
^:30 debug(GenDebug. "this.size", this.size); 

= //define the methods 

this.setPageFlag = PageHistory_setPageFlag; 
rU this.getPageFlag = PageHistory_getPageFlag; 

[35 this.isNotlnHistory = PageHistoryJsNotlnHistory; 

debug(GenDebug. "pages". dumpObject(this.pages)); 



40 



} 

var pageHistory = new PageHistory{20); 
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allowSubmit(name) 
Description: 

5 checks if a page is allowed to be submitted. If it is allowed to do so, returns true and sets its 

flag to 0 so that it won't be allowed again. 

to be called on a onSubmit handler 

======================================================================*/ 

10 function allowSubmit(name, confinnFlag) { 
uKey = pageHistory.getPageFlag{name) 
debug{GenDebug. "uKey", uKey); 
if {uKey =="!"){ 

pageHistory.setPageFlag(name, "0"); 
15 return true; 

} else { 

if (confinnFlag) { 

return confirm("This fomn has previously been submited. Submitting again may result in an 
error. Do you want to submit?"); 
20 } else { 

alert{'This Form has previously been submited. It cannot be submited again."); 
return false; 

C3 } 
« } 
^25 } 

H /*================================================:====================== 

sj putPagelnHistory(name) 

SfSO Description: 

^ ^ puts a page in history if it is not there, with a flag allowing it to be submitted. 

- To be called at the beginning of your page 

ry =:=====================================================================*/ 

£35 function putPagelnHistory(name) { 

m debug(GenDebug. "pageHistory.isNotlnHistory(name)", pageHistory.isNotlnHistory(name)); 

£3 if (pageHistory.isNotlnHistory(name)) { 

?^ pageHistory.setPageFlag(name. "1 "); 

} 

40 } 

function dumpObject(obj) { 
var dump = ""; 

for (var i in obj) dump += i + + obj[i] + "\n"; 
45 return dump; 

} 
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/*====================================================================== 

getObjectO 

Description: convert object name string or object reference into a valid object reference 
5 for both browsers: this is a reference on which you can set some style attributes 

====================================================================== */ 

function getObject(obj) { 
var theObj; 

if (typeof obj == "string") { 
10 var iniObj; 

if (isNav6) { 

iniObj = document.getElementByld(obj); 

} 

else{ 

15 iniObj = evalfdocument." + coll + obj); 

} 

if (IsUndef(iniObj)) { 

return "undefined"; 

20 } 

if (isNav4) { 
C3 return iniObj; 

^■=^5 else { 

\ J // in the IE or NS6 case the iniObj. style object may be undefined 
ll If (lsDef(iniObj. style)) { 

L : return iniObj. style; 

f2 } 

=?30 else { 

^ ^ return "undefined"; 

f. } 

t35 else { 

Ca theObj = obj; 

n ] 

r-, return theObj; 

} 

40 
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/*================================================================:====== 

getObjectRefO 

Description: convert object name string or object reference into a valid object reference 
5 for both browsers, without the style in IE: this is the real object reference 

this function is adapted from Danny Goodman's "Dynamic Html : The Definitive Reference" 
http://www.amazon.com/exec/obidos/ASIN/1565924940/qid%3D963012863/002-0174003- 
8509633 

==========:====================x==========^=^=====================:===== V 

function getObjectRef(obj) {//alertfgetRef "+obj); 
var theObj; 

if (typeof obj == "string") { 

var iniObj = evalfdocument." + coll + obj); 
//alert("getRef"+iniObj); 

if (lsUndef(iniObj)) { 

return "undefined 1"; 

} 

return iniObj; 

} 

else { 

theObj = obj; 
} 

return theObj; 

} 
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/* =============================================== 

FUNCTION: IsUndef 

INPUT: val - the value to be tested 

5 

RETURN: true, if the value is undefined 
false, otherwise. 

PLATFORMS: Netscape Navigator 3.01 and higher. 
10 Microsoft Internet Explorer 3.02 and higher, 

Netscape Enterprise Server 3.0, 
Microsoft IIS/ASP 3.0. 



function lsUndef( val ) { 
15 var isValid = false; 

if (val+"" == "undefined") 
isValid = true; 

return isValid; 
20 } // end IsUndef 

function lsDef( val ) { 
C3 return !lsUndef(val); 

} // end IsUndef 

U * <pre> 

V I * This function 

^=2 * checks if the fomi is allowed to be submitted. 

;;$0 * if yes. it sets the action, then calls fonn.submit() 

\ y * 

= * Usage: 

H * 

fy * <code> 

05 * <a href="Javascript:submitFomn(ViMM/somefile.jsp*, *myForm\ 'someUniqueKey', true)"> 

fg * </code> 

zz. * 

f ^ * </pre> 
*/ 

40 function submitForm(action, formName. key. confirmFlag) { 

//we put a provision here to let the users of this function not provide the last argument, which the 
ndefaults to true 
if (lsUndef(confinmFlag)) { 
confirmFlag = true; 

45 } 

if {allowSubmit(key, confirmFlag)) { 

debug{GenDebug, "formName", fomnName); 
eval("document." + formName + ".action=V"' + action + "\""); 
eval("document." + formName + ".submit()"); 

50 } 
} 
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